fix(scripts): bump-objectui.sh --help 用哨兵定界，改 header 不再静默截断 (#6425) - #6470

Fixes #6425

问题

scripts/bump-objectui.sh 的 --help 用硬编码行号打印自己的头注释：

# NOTE: this line range is coupled to the header block above (usage → env →
# sibling layout, ending at "run from here"). Editing the header means moving
# it — #5960 added the pin-update step and had to.
sed -n '2,26p' "$0" | sed 's/^# \{0,1\}//'

行号与 header 内容之间没有任何机制耦合。往 header 加一行，帮助就静默截断；删一行，就越界打进下一段内部说明。两种情况都 exit 0、都打印了「一些东西」，所以截断的帮助和完整的帮助长得一模一样。

这不是假设的风险，它已经触发过一次：#5960 往 header 加了 pin 更新步骤，把真正的结尾从第 19 行推到第 26 行，PR #6421 只能手工挪这个魔法数字，并留下上面那条「请下一位作者注意」的 NOTE。注释不是机制——它把责任转嫁给了下一位作者，而失败是静默的，下一位作者不会被任何东西提醒。

改法

把行号换成哨兵 # --help ends here，让终止符与它所终止的内容放在一起：header 末尾多一行哨兵，--help 打到哨兵为止。

if ! grep -qxF '# --help ends here' "$0"; then
  echo "✗ ${0##*/}: the '# --help ends here' sentinel is missing — cannot tell" >&2
  echo "  where the help text ends. Restore it at the end of the header block." >&2
  exit 1
fi
sed -n '2,/^# --help ends here$/p' "$0" \
  | grep -vxF '# --help ends here' \
  | sed 's/^# \{0,1\}//'

相对 issue 里给出的形状，有三处刻意的偏离，逐条说明：

1. grep -vxF 而不是 grep -v -- '--help ends here'。 issue 的写法按子串过滤，会把 header 里任何提到这句话的行一并吃掉——而这次改动恰好需要在文件里写下哨兵的说明文字。-x（整行）+ -F（字面量）只精确剔掉哨兵那一行。实测：脚本里该字符串按子串出现 6 次（第 27、73、84、85、89、90 行），整行精确匹配只命中 1 次（第 27 行，哨兵本身）——闸自己那行、报错文案那行、sed 那行、以及说明注释都不误伤。

2. 加了哨兵缺失的硬闸。 sed -n '2,/RE/p' 在 RE 匹配不到时会一路打印到 EOF——那正是本卡要消灭的「静默失败」换了个方向。实测：删掉哨兵后，无闸的管道会吐出 231 行整个脚本。现在改为 exit 1 并说明如何恢复。闸只设在 --help 分支，不设在启动路径：删掉一条注释不该让真正的 pin bump 跑不起来。

3. 起始的 2 保留。 严格说 2 也是行号，但它定位的是 shebang——位置由 execve 固定，不随 header 内容漂移。本卡要消灭的是结尾随 header 增删而漂移；开头不会漂。改成起始哨兵反而要多耦合一行文本，得不偿失。

删掉的 NOTE（分诊硬要求）

:66-68 那条来自 PR #6421 的「手工耦合」NOTE 在哨兵落地后即成假话，已在同一次改动里删除。留着它只是把谎言搬个家（同 #6458 的形状）。

验证

1. 输出逐字节一致

$ diff help-before.txt help-after.txt   # 空
$ cmp help-before.txt help-after.txt    # 静默
before: 25 lines, 1363 bytes, exit 0
after : 25 lines, 1363 bytes, exit 0

同时断言输出非空且不含哨兵字符串——两者必须一起断言：单独一条「哨兵没出现」在输出全空时也会真空通过。

2. 加行探针：机制真的生效（先声明方向，再跑）

对改前和改后两份脚本施加同一探针，声明的预期方向是「旧红 / 新绿」：

四项实测结果与声明完全一致。探针 A 是本 issue 描述的截断；探针 B 是它的镜像（越界/挤掉），两个方向都复现了，且旧脚本两次都 exit 0——这正是「静默」的含义。探针改动只作用于仓库外的临时副本，未落入本 PR。

3. 哨兵缺失闸

删掉哨兵后：exit=1，stdout 0 字节（不是把整个文件吐出来），stderr 为 ✗ … sentinel is missing — cannot tell where the help text ends.

门禁

本仓库没有 shellcheck / shfmt 之类的 shell 脚本门（已核对 .github/workflows/*.yml 与 package.json 全部 check:*）——如实记录，未拿别的脚本顶替。

Changeset

无。仓库内部开发工具，无对外发布面 ⇒ 不写 changeset，改为打 skip-changeset 标签。

刻意没做的事

• 没有开扫荡。 分诊已确认「本仓今天只有这一个脚本是这形状，不成族」，全仓复核也只有这一处 sed -n '2, 行号打印。bump-objectui.sh 的 pin changeset 只收 feat|fix 且静默截断到 40 条 —— 破坏性 refactor! 进不了前端发布记录 #4731 在同一脚本里修 head -40 静默截断是修法先例，不是额外范围。
• 没有碰 build-console.sh / check-console-sha.mjs / check-objectui-pin-fresh.mjs 等其它 pin/refresh 脚本。
• 没有碰 content/docs/releases/。

Generated by Claude Code